home *** CD-ROM | disk | FTP | other *** search
/ TarGA Party / TarGA Party.iso / pinnacle / sv.inf < prev    next >
Encoding:
Text File  |  1993-01-16  |  6.4 KB  |  170 lines
  1.  ╔═════════════════════╗
  2.  ║                     ║
  3.  ║  WHY IS SV NEEDED?  ║
  4.  ║                     ║
  5.  ╚═════════════════════╝
  6.  
  7.  
  8.   The EGA video display card can support screens showing 43 lines, instead of
  9.   the usual 25 lines that IBM PC compatibles have been using for years.  The
  10.   more advanced VGA card (which is what most computers are now sold with) can
  11.   display up to 50 lines.  (Actually, both cards can also use other modes, but
  12.   43- and 50-line modes are the only modes that are being widely supported.)
  13.  
  14.   At the programming level, both modes are handled in a similar way.  For this
  15.   reason, we refer to them here as a single mode (which we call "43/50 mode"),
  16.   even though they look different.
  17.  
  18.   All of the programs in "The SEE Utilities" can detect if the user has set
  19.   his video card to 43/50 mode and behave appropriately.  Of course, many
  20.   users have hesitated to lock themselves into one of these modes because
  21.   until recently, MS-DOS did not support it very well.
  22.  
  23.   But now that MS-DOS works well with 43/50 mode, it is becoming popular.
  24.   Although the letters are somewhat harder to read than on a 25-line display,
  25.   you CAN get a lot more data on one screen.  Once you get used to 43/50 mode,
  26.   you start avoiding programs that don't support it!
  27.  
  28.   The SEE file viewer program does let the user toggle 43/50 mode on and off,
  29.   even if he started off in 25-line mode.  This is handy for taking a quick
  30.   overview of a large collection of text.  But as soon as the user exits the
  31.   SEE viewer, he is back in his original mode (usually 25-line mode).  What we
  32.   need is a way to let the user set 43/50 mode PERMANENTLY, without having to
  33.   know any arcane DOS commands.
  34.  
  35.  
  36.  
  37.  ╔══════════════════╗
  38.  ║                  ║
  39.  ║  THE SV COMMAND  ║
  40.  ║                  ║
  41.  ╚══════════════════╝
  42.  
  43.  
  44.   "SV" (short for "Set Video") is a small utility which can set your video
  45.   card into various modes.  It can set 43/50 mode, for example. It can also
  46.   save the state of your video card, so you can restore it if a "badly
  47.   behaved" program leaves you in a mode you dislike (e.g. cursor off, red
  48.   border with yellow blinking characters on a blue background, 40 columns per
  49.   line, and so on!).
  50.  
  51.   SV can be used in two ways.  You can feed it parameters at the DOS command
  52.   line,  or you can omit the parameters and use SV's simple menu interface.
  53.   (For use with "The SEE Utilities" -- in batch files -- you will usually use
  54.   it in the command-line mode, using the format:  SV <mode-letter> OK)
  55.  
  56.  
  57.   
  58.  ╒═══════════════╕
  59.  │  QUICK-START  │
  60.  ╘═══════════════╛
  61.  
  62.  
  63.   You can learn most of what you need to know about SV by entering the
  64.   following command at the DOS prompt:
  65.  
  66.   SV /?
  67.  
  68.   This displays a quick summary of the command-line options.
  69.  
  70.  
  71.  
  72.  ╒═══════════════╕
  73.  │  SAMPLE CODE  │
  74.  ╘═══════════════╛
  75.  
  76.  
  77.   If you wish to provide support for various video modes when you use "The SEE
  78.   Utilities", you will find it helpful to see how we have done it (and borrow
  79.   the relevant lines of batch file code).  The two files that you will want to
  80.   view are:
  81.  
  82.   START.BAT     The main batch file (hint:  search for the label :SVSET)
  83.   SETVIDEO.MNU  The GO-MENU definition used in the SVSET section of START.BAT
  84.  
  85.   To view the file START.BAT, enter the following command at the DOS prompt:
  86.  
  87.   SEE START.BAT
  88.  
  89.   The SEE program can copy the section of the code you want into another file
  90.   (using the [C]opy command key).  The lines that you require have been
  91.   clearly marked to indicate which ones you will need to copy.
  92.  
  93.   We encourage you to borrow code from START.BAT and use SETVIDEO.MNU in your
  94.   own application, as long as you follow the distribution requirements
  95.   explained in the "INTRO" ("Introduction to the utilities") on the main START
  96.   menu.
  97.  
  98.  
  99.  
  100.  ╒═════════════════════╕
  101.  │  WHY ADD THE CODE?  │
  102.  ╘═════════════════════╛
  103.  
  104.  
  105.   It takes a bit of extra time to add support for SV, but it does provide the
  106.   user with a choice of the following four modes:
  107.                           
  108.   ■ 25-line mode (monochrome)
  109.   ■ 25-line mode (color)
  110.   ■ 43/50 mode   (monochrome)
  111.   ■ 43/50 mode   (color)
  112.  
  113.   Many users will enjoy having a choice between 25-line and 43/50 modes and
  114.   will be appreciate being given this option.
  115.  
  116.   Some users may find it difficult to see text if they do not have access to
  117.   monochrome mode.  Although the programs in "The SEE Utilities" are easy to
  118.   read in a wide range of circumstances, occasionally people will hook up
  119.   color video display cards to monochrome monitors in such a way that some
  120.   lines of text show up as dark gray on light gray.  If you are not sure who
  121.   is going to be using your product, you should consider adding in SetVideo
  122.   support.
  123.  
  124.  
  125.  
  126.  ╒════════════════╕
  127.  │  SAVE/RESTORE  │
  128.  ╘════════════════╛
  129.  
  130.   Even if you don't use SV in your products, you should keep a copy handy,
  131.   somewhere in your DOS PATH.  (For information about DOS PATH, see your DOS
  132.   manual)  SV lets you save your video mode (when it is set up just the way
  133.   you like it) and restore it if it is set "wrong" -- usually because of a
  134.   badly-deigned program.  You can save yourself a lot of annoying reboots by
  135.   using SV in this way.
  136.  
  137.  
  138.  
  139.  ╔══════════════════════════╗
  140.  ║                          ║
  141.  ║  THE "MIDNIGHT" UTILITY  ║
  142.  ║                          ║
  143.  ╚══════════════════════════╝
  144.  
  145.  
  146.   Some authors like to equalize the DOS time-and-date stamp of all files in a
  147.   package just before they send out their finished product.  This makes the
  148.   product look less haphazard when the user does a DOS DIR command.  By
  149.   setting all files to the same time and date, it looks like your work came to
  150.   a definite and satisfying CONCLUSION, as opposed to simply grinding to a
  151.   halt for some reason!
  152.  
  153.   The traditional way to set the file times is to alter the date with the DOS
  154.   TIME command, and then use a commonly available utility named TOUCH.  This
  155.   is a bit awkward, and can even be disastrous if you forget to set your date
  156.   BACK after "touching" all the files!
  157.  
  158.   The MIDNIGHT utility solves that problem.  To set ALL files in your current
  159.   directory to midnight (00:00) of the current day, simply enter this command
  160.   at the DOS prompt:
  161.  
  162.   MIDNIGHT
  163.  
  164.   This will set the  dates and times  of files in the current directory.  You
  165.   can, however, specify another directory as a parameter, as in this example:
  166.  
  167.   MIDNIGHT C:\MYFILES
  168.  
  169.  
  170.